home *** CD-ROM | disk | FTP | other *** search
/ InterCD 2001 April / april_2001.iso / intercd / root / ^Palm / Internet / TGtelnet / README next >
Encoding:
Text File  |  1997-04-29  |  4.5 KB  |  94 lines
  1. This is the README for Top Gun Telnet, my first try at an application
  2. that uses the Palm Pilot Pro's built-in TCP/IP library.
  3.  
  4. Instructions
  5. ------------
  6.  
  7. Here's a brief set of instructions (obviously, you need to have a Palm
  8. Pilot Professional for this to work at all):
  9.  
  10.  o Start PPP from the "Network" section of the Prefs app.
  11.  o Go to the TG Telnet app.
  12.  o Enter the server hostname in the top line on the screen, and hit "Open".
  13.    You can enter a hostname or numerical IP, optionally followed by a
  14.    colon and a port number.
  15.  o Type into the bottom field (just above the buttons), and push "Send"
  16.    or "SendCR" to send the text with or without a return.  Use "^x" to send
  17.    a control-x, "\^" to send ^, "\\" to send \, "\e" to send ESC, etc.
  18.    The page up and page down keys on the Pilot send ^k and ^l, respectively.
  19.  o Once you have logged in, you may have to set your remote machine to
  20.    "echo" mode ("stty echo" on Unix) if you want your typing to appear in
  21.    the output window.
  22.  o The menus will let you change the font size and/or width of the terminal.
  23.    If you choose a width larger than you can see, the thick line above the
  24.    text entry field will become a simple scrollbar.  NOTE: the bar will
  25.    _not_ move as you drag it; it will only move when you lift your pen.
  26.    ALSO NOTE: If the screen does not update after you change font or width,
  27.    tap the Graffiti area (putting you into punctuation mode).  For some
  28.    reason, this (or a handful of other events) seems to unblock it.
  29.  o Hit "Close" to disconnect when you're done.
  30.  
  31. For best results, you should run "screen" on the machine to which to telnet.
  32. This will provide your applications with a VT100 environment, and handle
  33. things like virtual terminals, automatic screen redraws when you change
  34. width or font, and the ability to interrupt and resume login sessions.
  35.  
  36. The termcap entry for tgtelnet is contained in the accompanying "termcap"
  37. file, and duplicated here:
  38.  
  39. pi|pilot|tgtelnet:am:xn:bs:co#39:li#16:cl=\Ec:cm=\Em%+ %+ :ho=\Em  :nw=\Em~ :\
  40.     :so=\Eb:se=\EB:bl=^g:cr=^m:do=^j:le=^h:kP=^k:kN=^l:
  41.  
  42. To use it (and screen), put it in your server's /etc/termcap file.  Then,
  43. when you log in to your server using tgtelnet and do "stty echo", set your
  44. TERM environment variable to "tgtelnet", and run screen.
  45.  
  46. With this method, I have been able to run vi, emacs, elm, trn, and lynx.
  47. What more could you want?
  48.  
  49. Future Enhancements
  50. -------------------
  51.  
  52. OK, you could want more.  First of all, source.  It will be released when
  53. I get a little more free time after the semester is over.  Watch the
  54. pilot-unix mailing list for announcements.  Second of all, when I go
  55. home (_not_ in the US) at the end of the semester, I will be adding
  56. crytpo into the client, to hopefully make it ssh-compatible.
  57.  
  58. Comments and bug reports are welcome (though I don't promise not to
  59. put them aside or ignore them...); send them to the pilot-unix list
  60. or to me at the address below.
  61.  
  62. Legalese
  63. --------
  64.  
  65.     This software is copyrighted by the Regents of the University of
  66.     California.  The following terms apply to all files associated with
  67.     the software unless explicitly disclaimed in individual files.
  68.  
  69.     The authors hereby grant permission to use, copy, modify,
  70.     distribute, and license this software and its documentation for any
  71.     purpose, provided that existing copyright notices are retained in
  72.     all copies and that this notice is included verbatim in any
  73.     distributions. No written agreement, license, or royalty fee is
  74.     required for any of the authorized uses.  Modifications to this
  75.     software may be copyrighted by their authors and need not follow the
  76.     licensing terms described here, provided that the new terms are
  77.     clearly indicated on the first page of each file where they apply.
  78.  
  79.     IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
  80.     FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  81.     ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
  82.     DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
  83.     POSSIBILITY OF SUCH DAMAGE.
  84.  
  85.     THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
  86.     INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  87.     MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
  88.     NON-INFRINGEMENT.  THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
  89.     AND THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE
  90.     MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
  91.  
  92.    - Ian Goldberg, ISAAC Group, UC Berkeley
  93.      <iang@cs.berkeley.edu>
  94.